Skip to main content
Version: 8.4.08.4

SpreadBookMarkup

V8 Message Definiton

Live spread quotes with SpiderRock markup details for equity and future option spreads.

METADATA

AttributeValue
Topic2895-market-data-spreads
MLink TokenSpreadMktData
ProductSRSpread
accessTypeSELECT

Table Definition

FieldTypeKeyDefault ValueComment
skey_atenum - AssetTypePRI'None'SR Spread Key should have corresponding ProductDefinition record
skey_tsenum - TickerSrcPRI'None'SR Spread Key should have corresponding ProductDefinition record
skey_tkVARCHAR(12)PRI''SR Spread Key should have corresponding ProductDefinition record
isTestenum - YesNoPRI'None'Yes indicates that response is made of entirely of isTestYes SpreadExchOrders
ticker_atenum - AssetType'None'common spread underlier
ticker_tsenum - TickerSrc'None'common spread underlier
ticker_tkVARCHAR(12)''common spread underlier
SRspreadIDBIGINT0
priceFormatenum - PriceFormat'None'
bidPrice1DOUBLE0bid price
isBidPrice1Validenum - YesNo'None'
askPrice1DOUBLE0ask price
isAskPrice1Validenum - YesNo'None'
bidSize1INT0cumulative size at bidPrice
askSize1INT0cumulative size at askPrice
bidMask1INT UNSIGNED0exchange bid bit mask OptExch mask for NMS spreads zero for single exchange spreads
askMask1INT UNSIGNED0exchange ask bit mask OptExch mask for NMS spreads zero for single exchange spreads
bidExch1enum - OptExch'None'exchange at bid price with the largest size if any
askExch1enum - OptExch'None'exchange at ask price with the largest size if any
bidTimeDATETIME(6)'1900-01-01 00:00:00.000000'last bid price or size change
askTimeDATETIME(6)'1900-01-01 00:00:00.000000'last ask price or size change
updateTypeenum - UpdateType'None'
numStkLegsTINYINT UNSIGNED0
numFutLegsTINYINT UNSIGNED0
numOptLegsTINYINT UNSIGNED0
userDefinedenum - YesNo'None'
spreadClassenum - ToolSpreadClass'None'
containsHedgeenum - YesNo'None'
legBidPrcDOUBLE0
legAskPrcDOUBLE0
legBidSzINT0
legAskSzINT0
surfPrcDOUBLE0
surfDeltaFLOAT0
surfGammaFLOAT0
surfVegaFLOAT0
surfWtVegaFLOAT0
surfErrorTINYINT UNSIGNED0error code from surface price calc if any
minExpiryDATETIME(6)'1900-01-01 00:00:00.000000'expiry of earliest option legs
maxExpiryDATETIME(6)'1900-01-01 00:00:00.000000'expiry of latest option legs
minYearsFLOAT0
maxYearsFLOAT0
refUPrcFLOAT0reference underlier price
printPriceFLOAT0last spread print price if any
printTimeDATETIME(6)'1900-01-01 00:00:00.000000'
printSizeINT0last spread print size if any
printVolumeINT0
grpNumINT0
securityDescVARCHAR(24)''
filterIdBIGINT0tool server filter request ID
timestampDATETIME(6)'1900-01-01 00:00:00.000000'
MarkupLegsListJSON'JSON_OBJECT()'

PRIMARY KEY DEFINITION (Unique)

FieldSequence
skey_tk1
skey_at2
skey_ts3
isTest4

JSON Block (MarkupLegsList)

FieldTypeComment
legSecKeyOptionKey
legSecTypeenum - legSecType
legPriceFormatenum - legPriceFormat
legSecurityDescstringSecurity description
legSideenum - legSide
legRatioushortleg ratio 1 2 etc
legBidPricedoubleleg market bid
legBidSizeint
legAskPricedoubleleg market ask
legAskSizeint
legYearsfloat
legUPrcdouble
legSurfVolfloatleg surface volatility
legSurfPricefloatsurface price as of message arrival
legSurfDefloat
legSurfGafloat
legSurfVefloat
legSurfErrbyte

CREATE TABLE EXAMPLE QUERY

CREATE TABLE `SRSpread`.`MsgSpreadBookMarkup` (
`skey_at` ENUM('None','EQT','IDX','BND','CUR','COM','FUT','SYN','WAR','FLX','MUT','SPD','MM','MF','COIN','TOKEN','ANY') NOT NULL DEFAULT 'None' COMMENT 'SR Spread Key (should have corresponding ProductDefinition record)',
`skey_ts` ENUM('None','SR','NMS','CME','ICE','CFE','CBOT','NYMEX','COMEX','RUT','CIDX','ARCA','NYSE','OTC','NSDQ','MFQS','MIAX','DJI','CUSIP','ISIN','BXE','ESX','ANY','CXE','DXE','NXAM','NXBR','NXDUB','NXLS','NXLDN','NXML','NXMLT','NXOS','NXP','EUREX','CEDX','ICEFE') NOT NULL DEFAULT 'None' COMMENT 'SR Spread Key (should have corresponding ProductDefinition record)',
`skey_tk` VARCHAR(12) NOT NULL DEFAULT '' COMMENT 'SR Spread Key (should have corresponding ProductDefinition record)',
`isTest` ENUM('None','Yes','No') NOT NULL DEFAULT 'None' COMMENT 'Yes indicates that response is made of entirely of isTest=Yes SpreadExchOrders',
`ticker_at` ENUM('None','EQT','IDX','BND','CUR','COM','FUT','SYN','WAR','FLX','MUT','SPD','MM','MF','COIN','TOKEN','ANY') NOT NULL DEFAULT 'None' COMMENT 'common spread underlier',
`ticker_ts` ENUM('None','SR','NMS','CME','ICE','CFE','CBOT','NYMEX','COMEX','RUT','CIDX','ARCA','NYSE','OTC','NSDQ','MFQS','MIAX','DJI','CUSIP','ISIN','BXE','ESX','ANY','CXE','DXE','NXAM','NXBR','NXDUB','NXLS','NXLDN','NXML','NXMLT','NXOS','NXP','EUREX','CEDX','ICEFE') NOT NULL DEFAULT 'None' COMMENT 'common spread underlier',
`ticker_tk` VARCHAR(12) NOT NULL DEFAULT '' COMMENT 'common spread underlier',
`SRspreadID` BIGINT NOT NULL DEFAULT 0,
`priceFormat` ENUM('None','N0','N1','N2','N3','N4','N5','N6','N7','F4','F8','Q8','F16','F32','H32','Q32','F64','H64','FullPenny','PartPenny','PartNickle','EQT','V1','V2','V3','V4','V5','V6','V7','V8','V9','V10','V11','V12','V13','V14','V15','A0','A1','A2','A3','A4','A5','A6','A7','E32') NOT NULL DEFAULT 'None',
`bidPrice1` DOUBLE NOT NULL DEFAULT 0 COMMENT 'bid price',
`isBidPrice1Valid` ENUM('None','Yes','No') NOT NULL DEFAULT 'None',
`askPrice1` DOUBLE NOT NULL DEFAULT 0 COMMENT 'ask price',
`isAskPrice1Valid` ENUM('None','Yes','No') NOT NULL DEFAULT 'None',
`bidSize1` INT NOT NULL DEFAULT 0 COMMENT 'cumulative size at bidPrice',
`askSize1` INT NOT NULL DEFAULT 0 COMMENT 'cumulative size at askPrice',
`bidMask1` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT 'exchange bid bit mask (OptExch mask for NMS spreads; zero for single exchange spreads)',
`askMask1` INT UNSIGNED NOT NULL DEFAULT 0 COMMENT 'exchange ask bit mask (OptExch mask for NMS spreads; zero for single exchange spreads)',
`bidExch1` ENUM('None','AMEX','BOX','CBOE','ISE','NYSE','PHLX','NSDQ','BATS','C2','NQBX','MIAX','GMNI','CME','CBOT','NYMEX','COMEX','ICE','EDGO','MCRY','MPRL','SDRK','DQTE','EMLD','CFE','MEMX','EUREX','CEDX','NXAM','NXBR','NXLS','NXML','NXOS','NXP','ICEFE') NOT NULL DEFAULT 'None' COMMENT 'exchange at bid price with the largest size (if any)',
`askExch1` ENUM('None','AMEX','BOX','CBOE','ISE','NYSE','PHLX','NSDQ','BATS','C2','NQBX','MIAX','GMNI','CME','CBOT','NYMEX','COMEX','ICE','EDGO','MCRY','MPRL','SDRK','DQTE','EMLD','CFE','MEMX','EUREX','CEDX','NXAM','NXBR','NXLS','NXML','NXOS','NXP','ICEFE') NOT NULL DEFAULT 'None' COMMENT 'exchange at ask price with the largest size (if any)',
`bidTime` DATETIME(6) NOT NULL DEFAULT '1900-01-01 00:00:00.000000' COMMENT 'last bid price or size change',
`askTime` DATETIME(6) NOT NULL DEFAULT '1900-01-01 00:00:00.000000' COMMENT 'last ask price or size change',
`updateType` ENUM('None','PrcChange','SizeOnly','PrevPeriod') NOT NULL DEFAULT 'None',
`numStkLegs` TINYINT UNSIGNED NOT NULL DEFAULT 0,
`numFutLegs` TINYINT UNSIGNED NOT NULL DEFAULT 0,
`numOptLegs` TINYINT UNSIGNED NOT NULL DEFAULT 0,
`userDefined` ENUM('None','Yes','No') NOT NULL DEFAULT 'None',
`spreadClass` ENUM('None','Stk','Fut','Call','Put','Synth','RevCon','Box','JRoll','Roll','Straddle','Strangle','CSpread','PSpread','VStrip','VSpread','HStrip','HSpread','BFly','RiskRev','Mixed','VarSwap') NOT NULL DEFAULT 'None',
`containsHedge` ENUM('None','Yes','No') NOT NULL DEFAULT 'None',
`legBidPrc` DOUBLE NOT NULL DEFAULT 0,
`legAskPrc` DOUBLE NOT NULL DEFAULT 0,
`legBidSz` INT NOT NULL DEFAULT 0,
`legAskSz` INT NOT NULL DEFAULT 0,
`surfPrc` DOUBLE NOT NULL DEFAULT 0,
`surfDelta` FLOAT NOT NULL DEFAULT 0,
`surfGamma` FLOAT NOT NULL DEFAULT 0,
`surfVega` FLOAT NOT NULL DEFAULT 0,
`surfWtVega` FLOAT NOT NULL DEFAULT 0,
`surfError` TINYINT UNSIGNED NOT NULL DEFAULT 0 COMMENT 'error code from surface price calc (if any)',
`minExpiry` DATETIME(6) NOT NULL DEFAULT '1900-01-01 00:00:00.000000' COMMENT 'expiry of earliest option leg(s)',
`maxExpiry` DATETIME(6) NOT NULL DEFAULT '1900-01-01 00:00:00.000000' COMMENT 'expiry of latest option leg(s)',
`minYears` FLOAT NOT NULL DEFAULT 0,
`maxYears` FLOAT NOT NULL DEFAULT 0,
`refUPrc` FLOAT NOT NULL DEFAULT 0 COMMENT 'reference underlier price',
`printPrice` FLOAT NOT NULL DEFAULT 0 COMMENT 'last spread print price (if any)',
`printTime` DATETIME(6) NOT NULL DEFAULT '1900-01-01 00:00:00.000000',
`printSize` INT NOT NULL DEFAULT 0 COMMENT 'last spread print size (if any)',
`printVolume` INT NOT NULL DEFAULT 0,
`grpNum` INT NOT NULL DEFAULT 0,
`securityDesc` VARCHAR(24) NOT NULL DEFAULT '',
`filterId` BIGINT NOT NULL DEFAULT 0 COMMENT 'tool server filter request ID',
`timestamp` DATETIME(6) NOT NULL DEFAULT '1900-01-01 00:00:00.000000',
`MarkupLegsList` JSON NOT NULL DEFAULT JSON_OBJECT() CHECK(JSON_VALID(MarkupLegsList)),
PRIMARY KEY USING HASH (`skey_tk`,`skey_at`,`skey_ts`,`isTest`)
) ENGINE=SRSE DEFAULT CHARSET=LATIN1 COMMENT='Live spread quotes with SpiderRock markup details for equity and future option spreads.';

SELECT TABLE EXAMPLE QUERY

SELECT
`skey_at`,
`skey_ts`,
`skey_tk`,
`isTest`,
`ticker_at`,
`ticker_ts`,
`ticker_tk`,
`SRspreadID`,
`priceFormat`,
`bidPrice1`,
`isBidPrice1Valid`,
`askPrice1`,
`isAskPrice1Valid`,
`bidSize1`,
`askSize1`,
`bidMask1`,
`askMask1`,
`bidExch1`,
`askExch1`,
`bidTime`,
`askTime`,
`updateType`,
`numStkLegs`,
`numFutLegs`,
`numOptLegs`,
`userDefined`,
`spreadClass`,
`containsHedge`,
`legBidPrc`,
`legAskPrc`,
`legBidSz`,
`legAskSz`,
`surfPrc`,
`surfDelta`,
`surfGamma`,
`surfVega`,
`surfWtVega`,
`surfError`,
`minExpiry`,
`maxExpiry`,
`minYears`,
`maxYears`,
`refUPrc`,
`printPrice`,
`printTime`,
`printSize`,
`printVolume`,
`grpNum`,
`securityDesc`,
`filterId`,
`timestamp`,
`MarkupLegsList`
FROM `SRSpread`.`MsgSpreadBookMarkup`
WHERE
/* Replace with a ENUM('None','EQT','IDX','BND','CUR','COM','FUT','SYN','WAR','FLX','MUT','SPD','MM','MF','COIN','TOKEN','ANY') */
`skey_at` = 'None'
AND
/* Replace with a ENUM('None','SR','NMS','CME','ICE','CFE','CBOT','NYMEX','COMEX','RUT','CIDX','ARCA','NYSE','OTC','NSDQ','MFQS','MIAX','DJI','CUSIP','ISIN','BXE','ESX','ANY','CXE','DXE','NXAM','NXBR','NXDUB','NXLS','NXLDN','NXML','NXMLT','NXOS','NXP','EUREX','CEDX','ICEFE') */
`skey_ts` = 'None'
AND
/* Replace with a VARCHAR(12) */
`skey_tk` = 'Example_skey_tk'
AND
/* Replace with a ENUM('None','Yes','No') */
`isTest` = 'None';

Doc Columns Query

SELECT * FROM SRSpread.doccolumns WHERE TABLE_NAME='SpreadBookMarkup' ORDER BY ordinal_position ASC;